Sentencias habituales de script
Las sentencias más comunes se utilizan habitualmente para manipular datos de varias formas. Estas sentencias pueden escribirse sobre cualquier número de filas en el script y deben terminar siempre en punto y coma ";".
Todas las palabras clave del script pueden escribirse con cualquier combinación de caracteres en mayúscula o minúscula. Los nombres de campo y de variable utilizados en las sentencias, por supuesto, son sensibles a mayúsculas.
Utilice el desplegable de cada función para ver una breve descripción y la sintaxis de cada función. Haga clic en el nombre de la función en la descripción de la sintaxis si desea más detalles.
La sentencia alias se utiliza para establecer un alias según el cual un campo se renombrará cada vez que aparezca en el script.
Alias fieldname as aliasname {,fieldname as aliasname}
Esta sentencia crea un valor entero único por cada valor distinto evaluado en un campo encontrado durante la ejecución de script.
Autonumber *fieldlist
[Using namespace] ]
La sentencia binary se utiliza para cargar los datos desde otro documento QlikView, incluidos los datos de Section access.
Binary [[path] filename]
Ofrece una forma de mostrar los comentarios del campo (metadatos) desde bases de datos y hojas de cálculo. Los nombres de campo que no estén presentes en el documento se ignorarán. Si hubiera múltiples nombres de un mismo campo, se empleará el último valor.
comment *fieldlist using mapname
comment fieldname with comment
Ofrece una forma de mostrar los comentarios de una tabla (metadatos) desde bases de datos u hojas de cálculo.
comment-table tablelist using mapname
comment-table tablename with comment
La sentencia CONNECT sirve para definir el acceso de QlikView 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 conexión ODBC.
La sentencia Directory define en qué directorio buscar archivos de datos en subsiguientes sentencias LOAD, hasta que se incluya una nueva sentencia Directory.
Directory [path]
La sentencia Disconnect termina la actual conexión ODBC/OLE DB/Personalizada. Esta sentencia es opcional.
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 ejecución del script mediante una sentencia drop field. La propiedad "distinct" de una tabla se elimina tras una sentencia drop field.
drop-field fieldname [ , fieldname2 ...] [from tablename1 [ , tablename2 ...]]
drop fields fieldname [ , fieldname2 ...] [from tablename1 [ , tablename2 ...]]
Se pueden desechar del modelo de datos (y por tanto de la memoria) una o varias tablas internas de QlikView, en cualquier momento durante la ejecución del script mediante una sentencia drop table.
drop-table tablename [, tablename2 ...]
drop tables[ tablename [, tablename2 ...]
La sentencia Execute sirve para ejecutar otros programas mientras QlikView está cargando datos. Por ejemplo, para hacer las conversiones que sean necesarias.
Execute commandline
La sentencia force obliga a QlikView a interpretar los valores de campo de sentencias LOAD y SELECT subsiguientes como escritas solo con mayúsculas, solo con minúsculas, como si estuvieran siempre en mayúsculas o tal como aparecen (combinadas). Esta sentencia permite asociar valores de campo de tablas según distintas convenciones.
Force ( capitalization | case upper | case lower | case mixed )
La sentencia LOAD carga campos desde un archivo, desde datos definidos en el script, desde una tabla previamente cargada, desde una página web, desde el resultado de una sentencia SELECT posterior, o bien generando los datos automáticamente.
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 ]
La sentencia let es complementaria a la sentencia set, utilizada para definir variables de script. La sentencia let, al contrario que la sentencia set, evalúa la expresión del lado derecho del signo igual: ' =' antes de ser asignada a la variable.
Let variablename=expression
Una o varias tablas internas de QlikView pueden declararse explícitamente como parcialmente desconectadas durante la ejecución de un script mediante la sentencia Loosen Table. El uso de una o varias sentencias Loosen Table en el script hará que QlikView ignore cualquier configuración de tablas parcialmente desconectadas que se haya establecido antes de la ejecución del script.
loosen-table tablename [ , tablename2 ...]
Loosen Tables tablename [ , tablename2 ...]
La sentencia map ... using sirve para enlazar (mapear) un determinado valor de campo o expresión con los valores de una tabla de correspondencias específica. La tabla de correspondencias se crea mediante la sentencia Mapping.
Map *fieldlist Using mapname
La sentencia NullAsNull deshabilita la conversión de valores NULL a valores de cadena previamente establecidos por una sentencia NullAsValue.
NullAsNull *fieldlist
La sentencia NullAsValue especifica para qué campos se deberán convertir los valores NULL hallados en valores.
NullAsValue *fieldlist
La sentencia Qualify sirve para activar o desactivar la calificación de nombres de campo, es decir, que los nombres de campo recibirán el nombre de la tabla como prefijo.
Qualify *fieldlist
La sentencia rem se usa para insertar comentarios en el script o desactivar temporalmente sentencias de script, sin eliminarlas.
Rem string
Esta función de script renombra uno o varios campos de QlikView tras haberlos cargado.
rename-field (using mapname | oldname to newname{ , oldname to newname })
Rename Fields (using mapname | oldname to newname{ , oldname to newname })
Esta función de script renombra una o varias tablas internas de QlikView tras haberlas cargado.
rename-table (using mapname | oldname to newname{ , oldname to newname })
Rename Tables (using mapname | oldname to newname{ , oldname to newname })
Con la sentencia section es posible definir si las sentencias subsiguientes LOAD y SELECT deberán considerarse como datos o como una definición de derechos de acceso.
Section (access | application)
La selección de campos desde una fuente de datos ODBC o proveedor OLE DB se hace mediante sentencias SQL SELECT estándar. Sin embargo, si las sentencias SELECT son aceptadas o no, depende del driver ODBC o proveedor OLE DB empleado.
Select [all | distinct | distinctrow | top n [percent] ] *fieldlist
From tablelist
[Where criterion ]
[Group by fieldlist [having criterion ] ]
[Order by fieldlist [asc | desc] ]
[ (Inner | Left | Right | Full)Join tablename on fieldref = fieldref ]
La sentencia set se utiliza para definir variables de script. Éstas pueden servir para sustituir cadenas, rutas, unidades de disco, etc.
Set variablename=string
La sentencia sleep detiene la ejecución de script por un tiempo especificado.
Sleep n
La sentencia SQL le permite enviar un comando SQL cualquiera mediante una conexión ODBC o OLE DB.
SQL sql_command
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 conexión mediante connect.
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 conexión mediante connect.
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 conexión mediante connect.
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 ]
Esta función de script crea un archivo QVD o un CSV.
Store [ *fieldlist from] table into filename [ format-spec ];
Esta función de script permite asignar etiquetas a uno o más campos. Si se intenta etiquetar un nombre de campo no presente en el documento, se ignora el etiquetado. Si hubiera múltiples nombres de un mismo campo o etiqueta, se empleará el último valor.
Tag fields fieldlist using mapname
Tag field fieldname with tagname
La sentencia trace escribe una cadena en la ventana de Progreso de Ejecución de Script y en el archivo de registro (log) del script, cuando éste se utiliza. Es muy útil cuando se desea efectuar una depuración. Mediante el uso de expansiones de signo dólar de variables que se calculan antes de la sentencia trace, podemos personalizar el mensaje.
Trace string
La sentencia Unmap deshabilita el enlace de un valor de campo especificado por una sentencia Map … Using anterior, para campos cargados en lo sucesivo.
Unmap *fieldlist
La sentencia Unqualify sirve para desactivar la calificación de los nombres de campo que había sido previamente activada mediante la sentencia Qualify.
Unqualify *fieldlist
Es una opción que permite eliminar etiquetas de uno o más campos. Si se intenta desetiquetar un nombre de campo no presente en el documento, se ignora la acción de desetiquetar. Si hubiera múltiples nombres de un mismo campo o etiqueta, se empleará el último valor.
Untag fields fieldlist using mapname
Untag field fieldname with tagname