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.

Observação

Este tópico oferece um entendimento básico das variáveis no ACLScript. Para obter mais informações, consulte Trabalhar 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_idade_em_anos = 3

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

v_idade_em_anos = 3

Observação

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 Tipo 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 idade > v_idade_em_anos
v_idade_em_anos = 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_tabela = "erp_data"
OPEN %v_table%

Tipos de variáveis

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

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

    Observação

    Para definir uma variável permanente, prefixe o identificador com um sublinhado (_): _v_company_name = 'Acme'.

  • variáveis de sessãopermanecem 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: OUTPUTFOLDER
  • identificadores de variáveis permanentes devem conter um caractere de sublinhado (_) prefixo: _v_permanent
  • identificadores de variáveis de sessão usam o formato v_varname 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.