Executa um script secundário ou externo de dentro de um script do Analytics.
Sintaxe
DO <SCRIPT> nome_script {<IF teste>|<WHILE teste>}
Parâmetros
| Nome | Descrição |
|---|---|
| SCRIPT nome_do_script |
O nome do script a ser executado. Você pode executar scripts secundários no projeto do Analytics ou em scripts externos armazenados em arquivos de texto com extensões como .aclscript, .txt. ou .bat. Você pode especificar um caminho de arquivo para um script externo. O caminho deverá estar entre aspas se tiver espaços. Nota Não é possível chamar um script que já está sendo executado. Por exemplo, se o ScriptA chamar o ScriptB, o ScriptB não pode chamar o ScriptA. O ScriptA ainda está sendo executado enquanto espera pelo ScriptB ser concluído. |
| IF teste opcional |
Uma expressão condicional que é avaliada apenas uma vez para determinar se o script deve ser executado. Se a condição for avaliada como verdadeira, o script será executado, caso contrário, ele não será. Não pode ser usada com WHILE no mesmo comando. Se ambos forem usados, WHILE será ignorado quando o script for processado. Um comentário é inserido no log, mas o script não é interrompido. |
| WHILE teste opcional |
Uma expressão condicional que é avaliada após a execução do script para determinar se o script deve ser executado novamente. Se o teste for avaliado como verdadeiro, o script será executado novamente, caso contrário, ele não será. Nota Se usar WHILE, verifique se o teste é avaliado como false em algum momento. Caso contrário, o script entrará em um loop infinito. Em caso de loop infinito, pressione a tecla Esc para cancelar o processamento do script. Não pode ser usado com IF no mesmo comando. Se ambos forem usados, WHILE será ignorado quando o script for processado. Um comentário é inserido no log, mas o script não é interrompido. |
Exemplos
Execução repetida de um subscript até que a entrada seja validada
Você tem um subscript que coleta entradas do usuário usando uma caixa de diálogo. O script faz o seguinte:
- Solicita os valores necessários ao cliente.
- Verifica a entrada do usuário.
- Define a variável v_validado como verdadeira quando os valores de entrada do usuário são validados.
Para garantir que o usuário insira uma entrada válida, use DO SCRIPT e inclua uma condição WHILE para que o script repita esse comando até a validação da entrada. Uma vez que o valor da variável for alterado, o script principal passará ao comando seguinte:
DO SCRIPT ObterEntradaUsuário WHILE v_validado = F
Execução de um subscript de um local compartilhado
Você mantém subscripts utilitários em um local compartilhado. Quando precisar de um deles durante uma análise, faça referência ao subscript usando o caminho completo para o local compartilhado:
DO SCRIPT "C:\Meus scripts utilitários\ObterEntradaUsuário.aclscript" WHILE v_validado = F
Observações
Comandos relacionados
DO SCRIPT equivale ao comando DO BATCH encontrado em scripts criados com versões anteriores do Analytics.
Você não pode usar o comando DO SCRIPT dentro de um comando GROUP.
Utilidade de um script externo
O armazenamento externo de um script e sua execução de um script do Analytics será útil se você quiser reutilizar o mesmo subscript em scripts e projetos do Analytics diferentes.
É possível armazenar uma única cópia do script em um local e atualizá-lo nesse local em vez de mantê-lo em diversos locais.
