Seu primeiro script do Analytics

Este tutorial breve e simples mostra os conceitos básicos do ACLScript. O tutorial trata apenas da abertura de uma tabela e da extração de um subconjunto de registros; no entanto, o ACLScript dispõe de funcionalidades muito mais abrangentes.

O que você precisa?

Neste tutorial, supomos que você já instalou e ativou o Analytics e que tem acesso aos dados de amostra fornecidos com o aplicativo.

Nota

Por padrão, os projetos de dados de amostra são instalados em C:\Usuários\nome_de_usuário\Documentos\ACL Data\Arquivos de dados da amostra no sistema de arquivos local.

Configuração

Abrir o projeto de amostra do Analytics

  1. Abra o ACL para Windows.
  2. Clique em Abrir projeto de análise e, na pasta ACL Data\Arquivos de dados da amostra, selecione Sample Project.ACL.

Criar o primeiro script

  1. No Navegador, na guia Visão geral, clique na pasta Scripts e selecione Novo > Script.

    O script Novo_Script é adicionado ao Navegador e aberto no editor de script.

  2. Clique com o botão direito do mouse em Novo_Script, selecione Renomear e insira extrair_faturas.

Lógica do script

Neste script, usaremos o ACLScript para:

  1. Abrir a tabela Trans_Cp.
  2. Copiar todos os registros da tabela com valor de fatura superior a 1000,00 e armazená-los em uma nova tabela denominada Trans_Cp_ValorAlto.
  3. Abrir a nova tabela para verificar os resultados.

Abrir a tabela Trans_Cp

Os dados são armazenados em tabelas. Portanto, para trabalhar com os dados, precisamos antes abrir uma tabela. O comando OPEN informa que você está trabalhando com a tabela especificada e disponibiliza seus dados para os comandos do script:

OPEN Trans_Cp

Copie essa linha, cole-a no editor de script e clique em Executar na barra de ferramentas do editor.

Se a tabela Trans_Cp abrir, seu script estará funcionando corretamente. Feche a tabela e continue.

Extrair todos os registros para Trans_Cp_ValorAlto e fechar Trans_Cp

Agora que o script está trabalhando com a tabela Trans_Cp, podemos usar o comando EXTRACT para copiar os registros de Trans_Cp para uma nova tabela denominada Trans_Cp_ValorAlto:

EXTRACT RECORD TO 'Trans_Cp_ValorAlto'
CLOSE Trans_Cp

Copie essa linha, cole-a no editor de script em uma linha após o comando OPEN e clique em Executar na barra de ferramentas do editor.

A tabela Trans_Cp_ValorAlto deve aparecer no Navegador em Tabelas > Contas a pagar. Essa nova tabela contém os registros copiados de Trans_Cp.

Extrair o subconjunto de registros para Trans_Cp_ValorAlto e fechar Trans_Cp

Neste ponto, podemos adicionar um parâmetro condicional IF ao comando EXTRACT para copiar apenas os registros de faturas com valores acima de 1000,00.

Note como o parâmetro IF é usado para testar se o valor do campo Valor_Fatura é maior que 1000,00. Se esse teste não for avaliado como verdadeiro, o registro não será extraído:

EXTRACT RECORD TO 'Trans_Cp_ValorAlto' IF Valor_Fatura > 1000,00
CLOSE Trans_Cp

Copie essa linha, substitua o comando EXTRACT existente no editor pela linha copiada e clique em Executar na barra de ferramentas do editor.

Quando solicitado, clique em Sim para sobrescrever a tabela Trans_Cp_ValorAlto. Agora, a tabela Trans_Cp_ValorAlto contém os registros copiados com valores acima de 1000,00 de Trans_Cp.

Abrir a tabela Trans_Cp_ValorAlto

Finalizaremos o script abrindo a nova tabela Trans_Cp_ValorAlto para permitir a verificação dos resultados do comando EXTRACT. Como esta é a última ação do script, a tabela é aberta e você poderá examinar os registros:

OPEN Trans_Cp_ValorAlto

Copie essa linha, cole-a no editor de script em uma linha após o comando EXTRACT e clique em Executar na barra de ferramentas do editor.

Agora, a tabela Trans_Cp_ValorAlto abre quando o script conclui e você pode examinar os registros extraídos de Trans_Cp.

O script completo

OPEN Trans_Cp

EXTRACT RECORD TO 'Trans_Cp_ValorAlto' IF Valor_Fatura > 1000,00
CLOSE Trans_Cp

OPEN Trans_Cp_ValorAlto

O que fazer em seguida