Funções do sistema
As funções do sistema fornecem funções de acesso às propriedades do sistema, dispositivo e documento do QlikView.
Use a caixa suspensa em cada função para ver uma breve descrição e a sintaxe de cada função. Para algumas das funções, você pode obter mais detalhes clicando no nome da função na descrição da sintaxe.
Esta função de script retorna uma string contendo a propriedade do autor do documento atual. Pode ser usado no script de carregamento e em um gráfico de expressão.
Author( )
Esta função retorna a string de agente do usuário do navegador do cliente. Pode ser usado no script de carregamento e em um gráfico de expressão.
Exemplo:
Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/35.0.1916.114 Safari/537.36
ClientPlatform( )
Esta função retorna uma string que contém o nome do computador, conforme retornado pelo sistema operacional. Pode ser usado no script de carregamento e em um gráfico de expressão.
ComputerName( )
Esta função retorna o nome de cultura do local de agrupamento que é utilizado. Se a variável CollationLocale não tiver sido definida, o local real da máquina do usuário é retornado.
GetCollationLocale( )
Esta função retorna o valor de uma propriedade estendida nomeada no objeto da pasta com o ID de objeto fornecido. Se objectid não for fornecido, o objeto da pasta que contém a expressão será utilizado. Uma propriedade estendida é definida para o objeto de extensão em seu arquivo de definição.
GetExtendedProperty(name[, objectid])
GetObjectField() retorna o nome da dimensão. Index é um inteiro opcional representando a dimensão que deve ser retornada.
GetObjectField([index])
Esta função retorna o valor de uma chave no registro do Windows. Pode ser usado no script de carregamento e em um gráfico de expressão.
GetRegistryString(path, key)
Essa função pode ser usada somente no script e abre uma caixa de entrada que solicita ao usuário um valor durante a execução do script. Os parâmetros cue e caption são usados como textos de mensagem e legenda, respectivamente. A função retorna o valor inserido.
A função de caixa de entrada retorna NULL se o diálogo for cancelado, fechado ou não puder ser exibido.
Exemplo:
Load
Input('Enter value', 'Input box') as v,
Recno () as r
autogenerate 3;
Input(str cue [, str caption])
Esta função só pode ser usada no script e abre uma caixa de entrada durante a execução do script. Os parâmetros msg e caption são usados como textos de mensagem e legenda, respectivamente. O parâmetro mb_buttons define que botões serão exibidos na caixa de mensagem, de acordo com:
0 ou 'OK' para um único botão OK,
1 ou 'OKCANCEL' para dois botões, OK e Cancel,
2 ou 'ABORTRETRYIGNORE' para três botões, Abort, Retry e Ignore,
3 ou 'YESNOCANCEL' para três botões, Yes, No e Cancel,
4 ou 'YESNO' para dois botões, Yes e No,
5 ou 'RETRYCANCEL' para dois botões, Retry e Cancel.
O parâmetro mb_icons define que ícone será exibido na caixa de mensagem, de acordo com:
0 ou string vazia para nenhum ícone,
16 ou 'ICONHAND' para um ícone com um X, usado para erros críticos,
32 ou 'ICONQUESTION' para um ícone com um ponto de interrogação,
48 ou 'ICONEXCLAMATION' para o ícone com um ponto de exclamação, usado para pequenos erros, precauções e avisos
64 ou ícone 'ICONASTERISK' com um i, usado para mensagens informativas.
O parâmetro mb_defbutton define em que botão estará o foco quando a caixa de mensagem for exibida, de acordo com:
0 ou 'DEFBUTTON1' se for necessário que o primeiro botão tenha o foco,
256 ou 'DEFBUTTON2' se for necessário que o segundo botão tenha o foco,
512 ou 'DEFBUTTON3' se for necessário que o terceiro botão tenha o foco,
768 ou 'DEFBUTTON4' se for necessário que o quarto botão tenha o foco.
A função retorna um número inteiro que mostra que botão foi pressionado pelo usuário, de acordo com:
1 para OK,
2 para Cancel,
3 para Abort,
4 para Retry,
5 para Ignore,
6 para Yes,
7 para No,
Os parâmetros 3, 4 e 5 serão adicionados internamente, portanto, se outros valores numéricos além dos acima mencionados forem usados, pode-se obter uma combinação inesperada de ícones e botões.
A função de caixa de entrada retorna NULL se o diálogo não puder ser exibido.
Exemplo:
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 função retorna uma string que contém o nome do usuário atual, conforme retornado pelo sistema operacional. Pode ser usado no script de carregamento e em um gráfico de expressão.
OSUser( )
Essa função retorna a versão completa do QlikView e o número da compilação como uma string.
Retorna um caractere contendo o nome do usuário atual do QlikView, conforme inserido em uma seção de acesso.
QVuser( )
Esta função retorna uma data/hora de conclusão da última carga de dados. Pode ser usado no script de carregamento e em um gráfico de expressão.
ReloadTime( )
Essa função de gráfico retorna o nome de estado do objeto no qual é utilizado. O desenvolvedor do QlikView pode usar essa função para obter cores e textos dinâmicos quando o estado de um objeto for alterado. É importante observar que essa função destina-se apenas a objetos. Ela não pode ser usada em uma expressão de gráfico para determinar o estado ao qual se refere a expressão.