# Comandos de controle

Ao modificar dados do gráfico, você usa um subconjunto do script do Qlik Sense, que consiste em várias instruções. Um comando pode ser comum ou de controle.

Comandos de controle geralmente são utilizados para controlar o fluxo de execução do script. Cada cláusula de um comando de controle deve ser mantido dentro de uma linha do script e pode ser encerrado por ponto e vírgula ou fim da linha.

Prefixos nunca são aplicados a comandos de controle.

Todas as palavras-chave do script podem ser digitadas com qualquer combinação de caracteres maiúsculos e minúsculos.

Use a caixa suspensa em cada função para ver uma breve descrição e a sintaxe de cada função. Clique no nome da função na descrição da sintaxe para obter detalhes.

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/modifier-control-statements.htm)

#### Call

O comando de controle call chama uma sub-rotina que deve ser definida por um comando sub prévio.

[**Call**](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/ControlStatements/Call.htm) name ( [ paramlist ])

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/modifier-control-statements.htm)

#### Do..loop

A declaração de controle do..loop é uma construção de iteração de script que executa um ou vários comandos até uma condição lógica ser atendida.

[**do**](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/ControlStatements/do.htm) [ ( while | until ) condition ] [statements]  
[exit do [ ( when | unless ) condition ] [statements]  
loop [ ( while | until ) condition ]

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/modifier-control-statements.htm)

#### End

A palavra chave do script End é usada para fechar cláusulas If,Sub e Switch.

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/modifier-control-statements.htm)

#### Exit

A palavra chave do script Exit é parte do comando Exit Script, mas também pode ser usada para sair das cláusulas Do, For ou Sub.

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/modifier-control-statements.htm)

#### Exit script

Esse comando de controle interrompe a execução do script. Ele pode ser inserido em qualquer parte do script.

[**exit-script**](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/ControlStatements/exit-script.htm)[ (when | unless) condition ]

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/modifier-control-statements.htm)

#### For..next

O comando de controle for..next cria uma construção de iteração de script com um contador. Os comandos dentro do loop incluídos entre for e next serão executados para cada valor da variável do contador, entre os limites inferior e superior especificados.

[**For**](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/ControlStatements/For.htm) counter = expr1 to expr2 [ stepexpr3 ]

[statements]

[exit for [ ( when | unless ) condition ]

[statements]

Next [counter]

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/modifier-control-statements.htm)

#### For each ..next

O comando de controle for each..next cria uma construção de iteração de script que executa um ou vários comandos para cada valor de uma lista separada por vírgulas. Os comandos dentro do loop incluídos entre for e next serão executados para cada valor da lista.

[**for-each**](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/ControlStatements/for-each.htm) var in list

[statements]

[exit for [ ( when | unless ) condition ]

[statements]

next [var]

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/modifier-control-statements.htm)

#### If..then

O comando de controle if..then é uma construção de seleção do script que força a execução do script seguir caminhos diferentes, dependendo de uma ou várias condições lógicas.

Nota informativaComo o comando if..then é um comando de controle e, portanto, termina com um ponto e vírgula ou com um fim de linha, cada uma das quatro cláusulas possíveis (if..then,elseif..then, else e end if) não deve ultrapassar o limite da linha.

[**If**](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/ControlStatements/If.htm) condition then

[ statements ]

{ elseif condition then

[ statements ] }

[ else

[ statements ] ]

end if

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/modifier-control-statements.htm)

#### Next

A palavra chave do script Next é usada para fechar loops For.

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/modifier-control-statements.htm)

#### Sub

A declaração de controle sub..end sub define uma sub-rotina que pode ser acionada por meio de um comando call.

[**Sub**](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/ControlStatements/Sub.htm) name [ ( paramlist )] statements end sub

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/modifier-control-statements.htm)

#### Switch

O comando de controle switch é uma construção de seleção do script que força a execução do script siga caminhos diferentes, dependendo do valor de uma expressão.

[**Switch**](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/ControlStatements/Switch.htm) expression {case valuelist [ statements ]} [default statements] end switch

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/modifier-control-statements.htm)

#### To

A palavra chave do script To é usada em vários comandos de script.