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.

Nota

Este tópico oferece um entendimento básico das variáveis no ACLScript. Para obter informações mais detalhadas, consulte Trabalhando com variáveis no ACLScript.

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 ao identificador um prefixo com caractere de sublinhado ( _ ): _v_empresa_nome = '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 conter um caractere de sublinhado ( _ ) 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.