Quando você executa um script no Analytics, cada comando no script é processado em sequência até alcançar o fim do script.

Você não pode continuar a trabalhar no Analytics enquanto o script está sendo executado e você somente pode executar um script por vez. No entanto, você pode criar scripts que chamam e executam outros scripts através do comando DO SCRIPT.

Enquanto um script está sendo executado, o Analytics exibe o status de processamento e o nome do script, ou subscript, na barra de status.

Quando o script termina de executar, um ícone aparece na barra de status indicando se o script executou inteiramente com sucesso ou falhou . Se o script falhar, a linha em que o erro ocorreu é automaticamente destacada no Editor de Script.

Se necessário, você pode interromper o processamento de um script pressionando a tecla Esc ou fechando o Analytics.

Há duas maneiras diferentes de executar um script do menu principal:

  • Menu Aplicativos escolha um nome de script específico de um menu personalizado

    Para obter mais informações, consulte Adição de itens personalizados ao menu principal do Analytics.

  • Opção Ferramentas acesse uma lista de escolha com todos os scripts de um projeto
    1. Selecione Ferramentas > Executar script.
    2. Na caixa de diálogo Executar script, selecione o script a ser executado na lista de scripts disponíveis no projeto.
    3. Se você quiser especificar uma condição que deve ser avaliada como verdadeira para que o script seja executado, execute uma das seguintes ações:
      • digite uma expressão lógica na caixa de texto Se
      • clique em Se para criar uma expressão lógica usando o Construtor de expressões

        A expressão lógica é avaliada apenas uma vez para determinar se o script deve ser executado. Se a expressão for avaliada como falso, o script não será executado.

    4. Clique em OK.

Na guia Visão geral no Navegador, clique com o botão direito no script na exibição em árvore e selecione Executar.

Abra o script no Editor de script e clique em Executar na barra de ferramentas do Editor de script.

Ao realizar alterações em um script no Editor de Script, as alterações são automaticamente salvas ao executar o script.

Você pode executar um script da linha de comando do Windows ou de um arquivo de lote (*.bat), o que permite agendar o script usando um utilitário como o Windows Task Scheduler e executá-lo sem intervenção manual.

A sintaxe da linha de comando usa este formato básico:

caminho_e_nome_de_arquivo_do_executável_do_ACL caminho_e_nome_de_arquivo_do_projeto_do_ACL </vNomeVar=valor> /bNome_script </min>

Exemplo

A sintaxe de linha de comando abaixo abre Sample Project.ACL e executa um script denominado Calcular_valor_mediana.

"C:\Arquivos de Programas (x86)\Software ACL\ACL for Windows 14\ACLWin.exe" "C:\Usuários\nome_do_usuário\Documentos\ACL Data\Arquivos de dados da amostra\Sample Project.ACL" /vv_nome_tabela="Trans_Cp" /vv_nome_campo="Valor_Fatura" /bCalcular_valor_mediana

Sintaxe da linha de comando

Nota

Especifique os caminhos completos para o executável do Analytics e o projeto do Analytics, incluindo o nome e a extensão do arquivo. Coloque o caminho entre aspas se o caminho incluir espaços.

Parâmetro Detalhes Exemplo
"caminho_e_nome_de_arquivo_do_executável_do_ACL"

Especifica o caminho para o arquivo executável do Analytics e o nome desse arquivo (ACLWin.exe).

 
"C:\Arquivos de Programas (x86)\Software ACL\ACL for Windows 14\ACLWin.exe"
"caminho_e_nome_de_arquivo_do_projeto_do_ACL"

Especifica o caminho até o arquivo de projeto do Analytics e o nome do projeto (*.acl) que contém o script.

 
"C:\Usuários\nome_do_usuário\Documentos\ACL Data\Arquivos de dados da amostra\Sample Project.ACL"

/v

opcional

Especifica nomes de variáveis e atribui valores. As variáveis são inicializadas automaticamente quando o projeto do Analytics abre.

Não coloque um espaço entre a chave /v e o nome da variável. Por exemplo, para a variável v_nome_tabela:

/vv_nome_tabela="Trans_Cp"

Nota

O tipo de dados de um valor atribuído deve corresponder ao tipo de dados da variável no script. Se os tipos de dados não corresponderem, ocorrerá um erro "Incongruência do tipo de expressão" e o script falhará.

Use aspas para qualificar valores de caracteres e apóstrofos invertidos para qualificar valores de datahora.

Variáveis de caractere 

/vv_nome_tabela="Trans_Cp" /vv_nome_campo="Valor_Fatura"

Variável numérica 

/vv_materialidade=10000

Variáveis de datahora 

/vv_data_inicial=`20180101` /vv_data_final=`20180331`

 
/b

Especifica o nome do script a ser executado.

Não coloque um espaço entre a chave /b e o nome do script.

 
/bCalcular_valor_mediana

/min

opcional

 Especifica que o Analytics é minimizado quando abre.  

Diretrizes para a criação de um script para execução sem intervenção manual

Evite interação com o usuário

Não inclua nenhum dos seguintes comandos de interação com o usuário:

  • DIALOG
  • ACCEPT
  • PASSWORD
  • PAUSE

Em vez disso, especifique todas as variáveis necessárias e atribua valores usando a sintaxe de linha de comando explicada acima.
Suprimir caixas de diálogo de confirmação

Inclua o comando SET SAFETY OFF no início do script para que os arquivos possam ser sobrescritos como necessário sem a exibição das caixas de diálogo de confirmação. Inclua o comando SET SAFETY ON no final do script para restaurar o comportamento padrão.

Adicione o parâmetro OK depois de qualquer comando, como DELETE ou RENAME, que exibe normalmente uma caixa de diálogo de confirmação.
Sair do Analytics Encerre o script com o comando QUIT para sair do Analytics.

Você pode executar um script de um atalho do Windows.

  1. Crie um atalho para o Analytics.
  2. Clique com o botão direito no atalho e selecione Propriedades.
  3. No campo Destino, insira a sintaxe de linha de comando adequada (ver acima).
  4. Clique em OK.
  5. Clique duas vezes no atalho para executar o script.