Funciones de sistema
Las funciones de sistema permiten acceder a las propiedades del sistema, del dispositivo y del documento QlikView.
Utilice el desplegable de cada función para ver una breve descripción y la sintaxis de cada función. En algunas de las funciones puede ver más detalles sobre esa función específica haciendo clic en el nombre de la función en la descripción de la sintaxis.
Esta función devuelve una cadena que contiene la propiedad de autor del documento actual. Puede utilizarse tanto en el script de carga como en una expresión de gráfico.
Author( )
Esta función devuelve la cadena de agente de usuario del navegador cliente. Puede utilizarse tanto en el script de carga como en una expresión de gráfico.
Ejemplo:
Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/35.0.1916.114 Safari/537.36
ClientPlatform( )
Esta función devuelve una cadena con el nombre del ordenador, tal como lo devuelve el sistema operativo. Puede utilizarse tanto en el script de carga como en una expresión de gráfico.
ComputerName( )
Esta función 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 máquina del usuario.
GetCollationLocale( )
Esta función devuelve el valor de una determinada propiedad ampliada en el objeto de hoja con el correspondiente ID de objeto. Si no se especifica objectid, se utilizará el objeto de hoja que contiene la expresión. La propiedad ampliada para un objeto de extensión se define en su archivo de definición.
GetExtendedProperty(name[, objectid])
GetObjectField() devuelve el nombre de la dimensión. Index es un entero opcional que indica qué dimensión deberá devolverse.
GetObjectField([index])
Esta función devuelve el valor de una clave en el registro de Windows. Puede utilizarse tanto en el script de carga como en una expresión de gráfico.
GetRegistryString(path, key)
Esta función puede emplearse en el script únicamente y abre un cuadro de entrada que pide al usuario un valor durante la ejecución de script. Los parámetros cue y caption se emplean como texto de mensaje y texto de título, respectivamente. La función devuelve el valor introducido.
La función del cuadro de entrada devuelve NULL si el diálogo se cancela, se cierra o no se puede mostrar.
Ejemplo:
Load
Input('Enter value', 'Input box') as v,
Recno () as r
autogenerate 3;
Input(str cue [, str caption])
Esta función puede utilizarse únicamente en el script y abre un cuadro de mensaje durante la ejecución de script. Los parámetros msg y caption se emplean como texto de mensaje y texto de título, respectivamente. El parámetro mb_buttons define qué botones se mostrarán en el cuadro de mensaje, según los siguientes valores:
0 o 'OK' para un único botón OK,
1 o 'OKCANCEL' para dos botones, OK y Cancel,
2 o 'ABORTRETRYIGNORE' para tres botones, Abort, Retry y Ignore,
3 o 'YESNOCANCEL' para tres botones, Yes, No y Cancel,
4 o 'YESNO' para dos botones, Yes y No,
5 o 'RETRYCANCEL' para dos botones, Retry y Cancel,
El parámetro mb_icons define qué botones se mostrarán en el cuadro de mensaje, según los siguientes valores:
0 o cadena vacía para ningún icono,
16 o 'ICONHAND' para un icono con una X, utilizado para errores críticos,
32 o 'ICONQUESTION' para un icono con un signo de interrogación,
48 o 'ICONEXCLAMATION' para un icono con un signo de exclamación, utilizado para errores críticos, mensajes de cuidado y advertencias
64 o 'ICONASTERISK' para un icono con una i, utilizado para mensajes informativos.
El parámetro mb_defbutton define qué botón estará seleccionado cuando se muestre el cuadro del mensaje, según los siguientes valores:
0 o 'DEFBUTTON1' si el primer botón debe estar seleccionado,
256 o 'DEFBUTTON2' si el segundo botón debe estar seleccionado,
512 o 'DEFBUTTON3' si el tercer botón debe estar seleccionado,
768 o 'DEFBUTTON4' si el cuarto botón debe estar seleccionado.
La función devuelve un entero que muestra el botón que ha sido pulsado por el usuario, según los siguientes valores:
1 para OK,
2 para Cancel,
3 para Abort,
4 para Retry,
5 para Ignore,
6 para Yes,
7 para No
Los parámetros 3, 4 y 5 se añadirán de forma interna, de modo que si se emplean valores numéricos distintos de los mencionados, podría encontrarse con una combinación inesperada de iconos y botones.
La función del cuadro de entrada devuelve NULL si el diálogo no se puede mostrar.
Ejemplo:
Load
MsgBox('Message 2', 'msgbox', 'OKCANCEL', 'ICONASTERISK') as x, 2 as r
autogenerate 1;
MsgBox(str msg [, str caption [, mb_buttons [, mb_icons[, mb_defbutton]]]] )
Esta función devuelve una cadena que contiene el nombre del usuario actual, tal como lo devuelve el sistema operativo. Puede utilizarse tanto en el script de carga como en una expresión de gráfico.
OSUser( )
Esta función devuelve el número completo de la versión de QlikView como una cadena.
Devuelve una cadena que contiene el nombre del usuario QlikView actual, tal como se introdujo en la sección de acceso.
QVuser( )
Esta función devuelve una fecha-hora indicando el momento en que finalizó la última carga de datos. Puede utilizarse tanto en el script de carga como en una expresión de gráfico.
ReloadTime( )
Esta función de gráfico devuelve el nombre del estado del objeto en el que se ha utilizado. Un desarrollador de QlikView puede utilizar esta función para introducir texto dinámico y colores cuando se modifique el estado de un objeto. Es importante observar que esta función opera en objetos únicamente. No puede emplearse en una expresión de gráfico para determinar el estado al que hace referencia la expresión.