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.

Como as variáveis funcionam no ACLScript

Criação de variável e atribuição de um valor

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%

Tipos de variáveis

O Analytics usa os tipos de variáveis a seguir:

  • variáveis criadas pelo sistema criadas automaticamente após a execução de um comando
  • variáveis permanentes permanecem na memória do computador até que você as exclua e persistem após o fechamento do projeto do Analytics

    Nota

    Para definir uma variável permanente, acrescente o prefixo '_' ao identificador: _v_nome_empresa = 'Acme'.

  • variáveis de sessão permanecem na memória do computador até que você as exclua ou feche o projeto do Analytics

Identificadores de variáveis

Os identificadores de variáveis não distinguem maiúsculas de minúsculas e seguem determinadas convenções a respeito do tipo da variável:

  • identificadores de variáveis geradas pelo sistema usam maiúsculas: PASTADESAÍDA
  • identificadores de variáveis permanentes devem ter um prefixo '_': _v_permanente
  • identificadores de variáveis de sessão usam o formato v_nomedavariável por convenção, mas o uso dessa convenção não é obrigatório

Exibição de valores de variáveis

Durante o desenvolvimento ou depuração do script, pode ser necessário rastrear valores de variáveis ao longo da execução do script. Para capturar valores de variáveis no arquivo de log do script, use o comando DISPLAY:

DISPLAY v_período_em_anos

Quando o script encontra esse comando, grava o comando no arquivo de log. Para exibir o valor da variável nessa fase da execução do script, clique na entrada no log.

Dica

Você também pode usar variáveis como auxílio de depuração, inserindo pontos de interrupção no script e inspecionando os valores das variáveis na guia Variáveis do Navegador.