Conceitos básicos dos scripts do Analytics

O ACLScript é uma linguagem de comando que permite programar e automatizar comandos do Analytics. A estrutura e os componentes do ACLScript são simples, mas altamente eficientes.

Nota

Se você não tem nenhuma experiência anterior com scripts, sugerimos que visite a Academia para obter algum treinamento básico antes de usar este conteúdo. Para cursos sobre scripts e uso do Analytics, acesse www.highbond.com.

Comandos

Cada linha em um script executa um comando do ACLScript e inicia com o nome do comando. Um comando é uma instrução para executar uma operação no Analytics.

O nome do comando é seguido por um ou mais parâmetros, especificados como nome_parâmetro valor_parâmetro.

Dica

Dependendo do comando, alguns parâmetros são obrigatórios e outros opcionais. Você não precisa especificar os parâmetros opcionais. Se omitidos, o comando será executado sem eles. No entanto, se você omitir um parâmetro obrigatório, o Analytics usará o valor padrão para esse parâmetro.

Exemplo usando o comando CLASSIFY

O exemplo a seguir mostra o comando CLASSIFY com os seguintes parâmetros:

  • ON – especifica o campo da tabela a ser usado como base de classificação
  • SUBTOTAL – especifica campos opcionais para calcular o subtotal na saída
  • TO – especifica a tabela onde serão gravados os resultados do comando CLASSIFY

Note como cada parâmetro é seguido por um ou mais valores de parâmetro:

Notas importantes sobre a sintaxe do comando

  • a primeira palavra de uma linha de script deve ser um nome de comando
  • para a maioria dos comandos, a ordem dos parâmetros após o nome do comando não é importante
  • a maioria dos comandos exige a abertura da tabela de destino antes de executar o comando; acrescente OPEN nome_tabela antes desses comandos

Comentários

Como qualquer linguagem de script, o ACLScript permite a adição de comentários com a palavra-chave COMMENT. Use comentários para facilitar a compreensão do seu código e para comunicar-se com qualquer pessoa que tente ler, usar ou compreender o script. O ACLScript permite dois tipos de comentários:

  • comentários de uma linha todo o texto após COMMENT é ignorado até alcançar o final da linha
  • blocos de comentários de várias linhas começam com COMMENT e cada linha subsequente é ignorada até alcançar a palavra-chave END ou uma linha em branco

Para obter mais informações e exemplos, consulte Comentários.

Tipos de dados

O ACLScript permite quatro tipos de dados básicos:

  • lógico é o tipo de dados mais simples. Os dados lógicos expressam um valor de verdade, que pode ser verdadeiro ou falso
  • numérico contém dígitos de 0 a 9 e, opcionalmente, um sinal negativo e um ponto decimal
  • caractere uma série de um ou mais caracteres
  • datahora um valor de data, datahora ou hora expresso em um formato permitido

Cada tipo de dados é tratado de forma diferente pelo Analytics e pode ser usado em diversos comandos e funções. Para obter mais informações sobre tipos de dados, consulte Tipos de dados.

Expressões

Uma expressão em qualquer instrução que tem um valor. A forma mais simples de expressão é uma literal como 2 ou "teste". No entanto, as expressões normalmente são cálculos e podem ser tão complexas quanto você conseguir imaginar, usando qualquer combinação válida de operadores, condições, funções e valores:

((2 + (3 - 2)) * 2) > ROOT(9;0)

As expressões normalmente são usadas no Analytics para preencher campos calculados ou como entrada para lógica condicional. Para obter mais informações sobre expressões, consulte Expressões.

Funções

As funções são rotinas incorporadas que aceitam um número específico de parâmetros e retornam um único valor. Use funções para manipular conteúdo e variáveis de campo usadas em comandos.

Nota

As funções não modificam dados de campos. Elas geram e retornam um novo valor com base em um cálculo ou algoritmo que usa dados de campos ou variáveis como entrada. Use o valor retornado pela função como entrada para um comando.

As funções iniciam com o nome da função, seguido imediatamente por um parêntese de abertura, uma lista de zero ou mais valores passados para a função como argumentos separados por ponto e vírgula e um parêntese de fechamento.

Exemplo

A função BETWEEN(valor; mín; máx) recebe três argumentos e retorna verdadeiro se o valor está no intervalo ou falso se o valor está fora do intervalo:

  • valor – a expressão ou valor a testar
  • mín – o valor mínimo do intervalo
  • máx – o valor máximo do intervalo
BETWEEN(valor; 500; 5000)

Para obter mais informações sobre funções, consulte Funções.

Variáveis

Uma variável é um local de armazenamento temporário usado para manter um valor. As variáveis têm um identificador associado que permite referenciar e trabalhar com o valor armazenado na memória do computador.

O ACLScript usa o comando ASSIGN para criar uma variável e atribuir-lhe um valor ao mesmo tempo:

ASSIGN v_age_in_years = 3

Para simplificar, você pode omitir a palavra-chave ASSIGN. No entanto, ASSIGN é usado implicitamente e o mesmo comando é executado:

v_age_in_years = 3

Nota

O ACLScript não permite valores nulos. Todas as variáveis devem ter um valor associado de um dos tipos de dados compatíveis. O interpretador de scripts avalia o tipo de dados usando o formato e o qualificador de dados usados para atribuir o valor. Para obter mais informações, consulte Tipos de dados.

Utilizar variáveis

Após criar uma variável, você poderá referenciá-la em qualquer lugar onde referencia nomes de campos ou variáveis. Você também pode atribuir um novo valor à variável usando o comando ASSIGN.

EXTRACT RECORD TO 'result.fil' IF age > v_age_in_years
v_age_in_years = 5

Você também pode usar interpolação de cadeias ou substituição de variáveis para incluir uma variável em um literal de cadeia, colocando o nome da variável entre caracteres %. Quando o Analytics encontra a variável substituída, troca o espaço reservado pelo seu valor correspondente:

ASSIGN v_table = erp_data
OPEN %v_table%

Para obter mais informações sobre variáveis, consulte Variáveis.

Estruturas de controle

Uma estrutura de controle é um componente de um script que decide a direção a tomar com base nos parâmetros fornecidos. O ACLScript oferece lógica condicional e estruturas de loop.

Lógica condicional

O ACLScript implementa lógica condicional como um comando IF e como um parâmetro opcional em diversos comandos da linguagem.

Dica

Use o comando IF para controlar se um comando é executado ou não, e use o parâmetro IF para decidir qual a tabela usada na execução de um comando.

Comando IF

IF v_contador > 10 CLASSIFY ON número_cliente

Parâmetro IF

CLASSIFY ON número_cliente IF estado = 'SP'

Loop

O comando LOOP fornece a estrutura de controle de loops no ACLScript. Esse comando processará as instruções dentro do loop enquanto a expressão do teste de controle for avaliada como verdadeira.

Para obter mais informações sobre estrutura de controle, consulte Estruturas de controle