Executa um aplicativo ou processo externo ao Analytics. Emula o comando Run do Windows. Pode ser usado para interagir com o prompt de comando do Windows.

Nota

Como o comando EXECUTE oferece a capacidade de interagir com o sistema operacional e os aplicativos externos ao Analytics, podem surgir problemas técnicos além do escopo da funcionalidade nativa do Analytics.

O Suporte pode auxiliar na operação do comando EXECUTE dentro do Analytics, mas os problemas que ocorrem com os processos e aplicativos externos ao Analytics não são cobertos pelo Suporte.

EXECUTE sintaxe_comando_Run_Windows <ASYNC>
Nome Descrição
sintaxe_comando_Run_Windows

O nome do aplicativo a ser executado, a pasta ou arquivo a ser aberto ou o comando a ser executado, seguido por todos os argumentos ou chaves de comando necessários.

Exige uma sintaxe válida de comando Run do Windows entre aspas.

ASYNC

opcional

Executa os comandos em modo assíncrono.

No modo assíncrono, o script do Analytics continua a execução sem aguardar a conclusão do processo iniciado pelo comando EXECUTE.

Se você omitir ASYNC, o processo iniciado pelo comando EXECUTE deverá concluir antes que o script do Analytics continue. O Analytics fica inacessível durante a execução de processos externos.

Nota

Para executar EXECUTE na linha de comando do Analytics, você deve especificar ASYNC.
Nome Contém
RETURN_CODE

O código retornado por um aplicativo ou processo externo executado com o comando EXECUTE.

O que são códigos de retorno?

Os códigos de retorno são números gerados pelo aplicativo ou processo externo e devolvidos ao Analytics para indicar o resultado do processo externo. O Analytics não gera o código de retorno, apenas o recebe.

Códigos de retorno comuns

Códigos de retorno típicos são valores em números inteiros que mapeiam notificações específicas ou mensagens de erro. Por exemplo, o código de retorno "0" pode significar "A operação foi concluída com êxito". O código de retorno "2" pode significar "O arquivo especificado não foi encontrado pelo sistema".

O significado de códigos de retorno específicos

Os códigos de retorno específicos e seus significados podem variar de acordo com o aplicativo ou processo externo. Listas de códigos de retorno, também chamados de 'códigos de erro' ou 'códigos de saída', e de seus significados, podem frequentemente ser encontradas na documentação do aplicativo externo em questão. Listas de códigos de retorno também podem ser encontradas na Internet.

Variável criada apenas no modo padrão

A variável RETURN_CODE é criada quando o comando EXECUTE é usado no modo padrão. A variável não é criada quando o comando é executado em modo assíncrono.

Abrir um aplicativo

Abre o Microsoft Excel:

EXECUTE "Excel"

Abre o Adobe Acrobat Reader:

EXECUTE "AcroRd32.exe"

Fechar um aplicativo

Fecha o Microsoft Excel:

EXECUTE "TASKKILL /f /im Excel.exe"

Nota

Use a chave /f com cuidado. Ela força o fechamento de um aplicativo sem apresentar nenhuma caixa de diálogo, como as exibidas para salvar alterações.

Abrir um arquivo

Abre a pasta de trabalho do Excel Trans_CP.xlsx:

EXECUTE '"C:\Projetos ACL\Dados origem\Trans_CP.xlsx"'

Criar uma nova pasta

Cria uma nova pasta denominada Dados origem:

EXECUTE 'cmd /c MD "C:\Projetos ACL\Dados origem"'

Executar scripts externos ou arquivos em lotes não Analytics (.bat)

Executa o script Meu_lote.bat:

EXECUTE '"C:\Projetos ACL\Arquivos de lote\Meu_lote.bat"'

Passar parâmetros para um arquivo em lotes não Analytics

Passa dois parâmetros para Meu_lote.bat. Os parâmetros podem ser literais ou variáveis do Analytics:

EXECUTE '"C:\Projetos ACL\Arquivos de lote\Meu_lote.bat" param1%v_param2%'

Executar scripts do Analytics em outros projetos do Analytics

Executa "Script_Trans_CP" em Testes Trans CP.acl"

EXECUTE 'aclwin.exe "C:\Projetos ACL\Testes trans CP.acl" /b Script_trans_CP'

Nota

A execução de um script do Analytics em outro projeto inicia uma segunda instância do Analytics. O script no segundo projeto deve terminar com o comando QUIT para que a segunda instância do ACL feche e o controle seja devolvido à instância inicial do Analytics.

Incorporar um período de espera em um script do Analytics

Os dois exemplos criam um período de espera de 30 segundos:

EXECUTE "TIMEOUT /t 30"
EXECUTE "cmd /c PING -n 31 127.0.0.1 > nul"

Use EXECUTE para executar tarefas úteis

O comando EXECUTE permite a execução de comandos do Windows e do DOS a partir da linha de comando do Analytics ou de um script do Analytics.

Você pode usar esse recurso para incrementar a automação dos scripts do Analytics executando várias tarefas úteis que não são possíveis usando apenas a sintaxe do ACLScript.

Exemplos de tarefas que podem ser iniciadas usando EXECUTE

Abrir outros programas e aplicativos e executar as tarefas exigidas pelo script do Analytics Passar parâmetros para um arquivo em lotes Acessar dados de locais de rede Incorporar listas de contas do Active Directory
Abrir qualquer arquivo no seu aplicativo padrão Executar scripts do Analytics em outros projetos do Analytics Usar o FTP para cessar dados de locais remotos Integrar-se com VBScript
Executar tarefas administrativas de arquivos e pastas como cópia, movimentação, criação, exclusão ou comparação de arquivos ou pastas existentes fora do Analytics Incorporar períodos de espera em scripts do Analytics Compactar ou descompactar dados Integrar-se com bancos de dados SQL
Executar scripts externos ou arquivos em lotes não Analytics (.bat) Incorporar o agendamento de tarefas do Windows em scripts do Analytics Criptografar ou descriptografar dados Abrir páginas da web

Nota

Detalhes específicos sobre como executar qualquer dessas tarefas estão além do escopo da documentação de ajuda da Galvanize. Para obter auxílio, consulte a documentação adequada do sistema operacional Windows ou outra documentação de terceiros.

Modo padrão e assíncrono

Você pode executar o comando EXECUTE em modo padrão ou assíncrono:

  • Modo padrão o processo iniciado por EXECUTE deve ser concluído antes que o script do Analytics possa continuar.

    O Analytics fica inacessível durante a execução de processos externos.

  • Modo assíncrono o script do Analytics continua a execução sem aguardar a conclusão do processo iniciado pelo comando EXECUTE.

    O Analytics continua acessível durante a execução de processos externos.

    Se você especificar ASYNC, o comando EXECUTE executa em modo assíncrono.

Qual modo devo usar?

Quando você cria scripts do Analytics que usam o comando EXECUTE, precisa considerar qual é o modo de operação adequado.

Usar modo padrão Usar modo assíncrono/ASYNC
  • tarefas administrativas de arquivos e pastas
  • especificação de períodos de espera
  • qualquer tarefa da qual tarefas subsequentes dependem
  • execução de scripts subsequentes depende do resultado na variável RETURN_CODE
  • tarefas externas exibem uma caixa de diálogo de interface de aplicativo ou pop-up

Scripts do Analytics com execução autônoma

Se você quiser que um Script do Analytics que contém o comando EXECUTE executem de forma autônoma, use um dos seguintes métodos:

  • use o modo assíncrono para todas as tarefas que exibem uma caixa de diálogo de interface de aplicativo ou pop-up
  • evite abrir elementos de interface em scripts autônomos

Nota

Até serem fechados, os elementos de interface representam processos em execução. Se esses elementos de interface forem abertos com EXECUTE no modo padrão, impedirão a execução das linhas subsequentes de um script do Analytics, que ficará travado.

Comando EXECUTE em scripts de análise

Se você quer usar o comando EXECUTE em scripts de análises no Robôs ou no Servidor AX, deve configurar especificamente o comando a ser executado. Para obter mais informações, consulte:

Aspas

A sintaxe do comando Run do Windows usada com o comando EXECUTE deve estar entre aspas ou apóstrofos.

O exemplo abaixo usa o comando MD do Windows para criar uma nova pasta:

EXECUTE 'cmd /c md C:\Nova_Pasta_Dados'

Aspas aninhadas

Se qualquer caminho na sintaxe do comando Run contém espaços, os caminhos devem também estar entre aspas.

Você tem duas opções para colocar caminhos entre aspas:

  • Aspas dentro de apóstrofos Coloque toda a cadeia do comando Run entre apóstrofos e, internamente, os caminhos entre aspas:
    EXECUTE 'cmd /c md "C:\Nova Pasta Dados"'

    Esse método pode ser mais fácil de entender que o segundo método.

    Nota

    A inversão da ordem de aninhamento, usando aspas para toda a cadeia e apóstrofos para os caminhos, não funciona.

  • Duas aspas Coloque toda a cadeia do comando de execução entre aspas e, internamente, os caminhos entre duas aspas:
    EXECUTE "cmd /c md ""C:\Nova Pasta Dados"""

    Se você usar esse segundo método, as duas aspas usadas internamente devem ser adjacentes e sem espaços entre elas.

Comandos internos e externos

Os comandos do Windows podem ser internos ou externos.

  • Os comandos internos podem ser executados apenas do prompt de comando, o que significa que você tem de abrir o shell de comando usando cmd /c ou cmd /k antes de especificar o comando.
  • Os comandos externos podem ser executados do prompt de comando ou diretamente, usando o comando EXECUTE, o que significa que a abertura do shell de comando é uma opção, mas não é obrigatória.

O exemplo abaixo usa o comando interno do Windows DIR (exibe o conteúdo de um diretório) e o comando externo do Windows COMP (compara dois arquivos) para mostrar a diferença:

EXECUTE 'cmd /k dir "C:\DADOS ACL\Arquivos de dados da amostra"' 
EXECUTE 'comp C:\Arquivo_1.txt C:\Arquivo_2.txt'

Essa complicação pode ser evitada criando scripts ou arquivos de lote externos contendo comandos do Windows e usando o comando EXECUTE apenas para iniciar o arquivo de lote. Por exemplo:

EXECUTE 'C:\Meu_lote.bat'

Sintaxe do comando Run de várias linhas

O comando EXECUTE não suporta a sintaxe do comando Run de várias linhas. Para incorporar comandos RUN de várias linhas em um script do Analytics, use um dos seguintes métodos:

Método Exemplo
Repita o comando EXECUTE para cada comando Run. 
EXECUTE 'cmd /c md "C:\Nova pasta de dados"' EXECUTE 'cmd /c copy C:\Arquivo_1.txt "C:\Nova pasta de dados"'
Combine os comandos Run usando '&'. 
EXECUTE 'cmd /c md "C:\Nova pasta de dados" & copy C:\Arquivo_1.txt "C:\Nova pasta de dados"'
Crie um script ou arquivo de lote externo contendo comandos Run de várias linhas e usando o comando EXECUTE apenas para iniciar o arquivo de lote. 
EXECUTE 'C:\Meu_lote.bat'