Comando PAUSE

Suspende um script e exibe informações em uma caixa de diálogo aos usuários.

Sintaxe

PAUSE mensagem <IF teste>

Parâmetros

Nome Descrição
mensagem

Uma mensagem a ser exibida na caixa de diálogo. O comprimento máximo é 199 caracteres.

mensagem deve estar entre aspas. Se a mensagem tiver aspas, coloque-a entre apóstrofos.

IF teste

opcional

Uma expressão condicional que deve ser verdadeira para processar cada registro. O comando é executado apenas nos registros que atendem à condição.

Nota

O parâmetro IF é avaliado apenas em relação aos registros restantes em uma tabela depois da aplicação dos parâmetros de escopo (WHILE, FIRST, NEXT).

Exemplos

Exibição de uma mensagem de erro

Você precisa de uma entrada de usuário para cumprir requisitos específicos. Quando você detectar que a entrada não cumpre esses requisitos, use o comando PAUSE e exiba uma mensagem de erro em uma caixa de diálogo:

PAUSE "A classe do produto deve ser um valor de 2 dígitos."

Observações

Quando usar PAUSE

Use PAUSE para exibir mensagens somente para leitura durante a execução de um script. Você pode exibir mensagens de erro ou informações, como os resultados de uma operação analítica.

Como funciona?

Durante a exibição da caixa de diálogo, a execução do script é interrompida e somente é retomada depois que o usuário clicar em OK para fechar a caixa de diálogo da mensagem. Por esse motivo, não é possível usar PAUSE em scripts ou análises que devem executar automaticamente.

Limitações

PAUSE tem as seguintes limitações:

  • não pode ser incluído dentro do comando GROUP
  • não pode ser usado em análises executadas no Robôs ou no Servidor AX