Ir para conteúdo principal Pular para conteúdo complementar

When

O prefixo e o sufixo when são utilizados para criar uma cláusula condicional que determina se um comando ou uma cláusula exit deve ser executada. Pode ser considerado como uma alternativa compacta do comando if..end if.

Sintaxe:  

(when condition statement | exitstatement when condition )

Tipo de dados de retorno: Booleano

No Qlik Sense, o valor booleano “true” é representado por -1, e o valor falso é representado por 0.

A instrução ou a instrução de saída apenas será executada se a condição for avaliada como TRUE.

O prefixo Unless pode ser utilizado em comandos que já possuem um ou vários outros comandos, inclusive prefixos adicionais When ou When.

A instrução When retorna um resultado booleano. Normalmente, esse tipo de função será usado como uma condição quando o usuário quiser carregar ou excluir partes de um script.

Argumentos
Argumento Descrição
condition Uma expressão lógica que é avaliada como TRUE ou FALSE
statement Qualquer comando de script do Qlik Sense, exceto os de controle.
exitstatement Uma cláusula exit for, exit do ou exit sub ou um comando exit script.

Configurações regionais

A menos que especificado de outra forma, os exemplos neste tópico usam o seguinte formato de data: MM/DD/AAAA. O formato de data é especificado na instrução SET DateFormat no seu script de carregamento de dados. A formatação de data padrão pode ser diferente no seu sistema devido às suas configurações regionais e outros fatores. Você pode alterar os formatos nos exemplos abaixo para atender às suas necessidades. Ou pode alterar os formatos no seu script de carregamento para corresponder a esses exemplos. Para obter mais informações, consulte Modificando configurações regionais para aplicativos e scripts.

As configurações regionais padrão nos aplicativos são baseadas no perfil do usuário. Essas configurações de formato regional não estão relacionadas ao idioma exibido na interface do usuário do Qlik Cloud. O Qlik Cloud será exibido no mesmo idioma do navegador que você está usando.

Se você for um criador de aplicativos, poderá definir a região padrão para os aplicativos que criar. Para obter mais informações, consulte Definir suas configurações regionais preferidas para criar aplicativos e scripts no Qlik Cloud Analytics.

Exemplos de funções
Exemplo Resultado
exit script when A=1; Quando a instrução A=1 for avaliada como TRUE, o script será interrompido.
when A=1 LOAD * from myfile.csv; Quando a instrução A=1 for avaliada como TRUE, o myfile.csv será carregado.
when A=1 unless B=2 drop table Tab1; Quando a instrução A=1 for avaliada como TRUE e B=2 for avaliada como FALSE, a tabela Tab1 será descartada.

Exemplo 1: prefixo “when”

Exemplo 2: sufixo “when”

Exemplo 3: vários prefixos “when”

Esta página ajudou?

Se você encontrar algum problema com esta página ou seu conteúdo - um erro de digitação, uma etapa ausente ou um erro técnico - informe-nos como podemos melhorar!