Comando ASSIGN
Cria uma variável e atribui a ela um valor.
Sintaxe
ASSIGN nome_variável = valor <IF teste>
Nota
A especificação explícita da palavra-chave ASSIGN é uma prática recomendada, pois facilita a leitura e compreensão dos scripts. No entanto, você pode omitir a palavra-chave ASSIGN e simplesmente especificar:
nome_variável = valor
Parâmetros
| Nome | Descrição |
|---|---|
| nome_variável |
O nome da variável para a qual será atribuído o valor. A variável será criada, caso ela não exista. Se a variável existir, ela será atualizada com o novo valor. Não use caracteres que não sejam em inglês, como é, em nomes de variáveis que serão usadas na substituição de variáveis. Nomes variáveis que contenham caracteres não ingleses causarão falhas na substituição de variáveis. Nota Os nomes de variável são limitados a 31 caracteres alfanuméricos. O nome pode incluir o caractere de sublinhado ( _ ) mas nenhum outro caractere especial e nenhum espaço. O nome não pode começar com um número. |
| valor |
O valor a ser atribuído para a variável. Se uma nova variável for criada, o tipo da variável será baseado no tipo de dado em valor. |
| IF teste Opcional |
Uma expressão condicional que deve ser verdadeira para criar a variável ou atribuir o valor à variável. |
Exemplos
Como atribuir um valor a uma variável
Atribua o valor do campo Valor no registro atual a uma variável denominada v_valor_atual:
ASSIGN v_valor_atual = Valor
Atribuição condicional de um valor a uma variável
Você quer atualizar o valor de uma variável denominada v_quantidade para 1, mas apenas quando o valor de outra variável denominada v_contador for inferior a 10.
Se v_contador for maior ou igual a 10, nenhuma atribuição é feita e o valor de v_quantidade permanece inalterada.
Observe que a palavra chave opcional ASSIGN é omitida:
v_quantidade = 1 IF v_contador < 10
Observações
Para obter informações detalhadas sobre variáveis, consulte Trabalhando com variáveis no ACLScript.
Duração das variáveis
As variáveis só são retidas durante a sessão atual do Analytics. Normalmente, quando você fecha um projeto do Analytics, todas as variáveis do projeto são excluídas automaticamente.
Se você quiser que uma variável seja salva permanentemente com um projeto do Analytics, acrescente um sublinhado ao início do nome da variável:
ASSIGN _nome_variável = valor
Reatribuição de variáveis usadas em campo calculado ou GROUP
Se você atribuir um valor a uma variável existente nas situações a seguir, o novo valor será atribuído, mas o comprimento e o número de casas decimais do valor anterior serão mantidos:
- variáveis usadas em campos calculados
- variáveis reatribuídas dentro de um GROUP
Se necessário, o tamanho do novo valor será preenchido como brancos ou truncado e as casas decimais serão ajustadas.
Se você reatribuir uma variável em qualquer outro contexto, o valor anterior, bem como seu comprimento e especificações de decimais, serão sobrescritos.
Variáveis criadas por comandos do Analytics
As variáveis do sistema são criadas automaticamente pelo Analytics quando determinados comandos são executados, seja inserindo informações nas caixas de diálogos no Analytics ou executando scripts. É possível usar essas variáveis e os valores contidos nelas ao processar comandos subsequentes do Analytics.
O valor em uma variável do sistema é substituído por um valor atualizado se você executar o mesmo comando novamente.
Para obter mais informações, consulte Variáveis de sistema criadas por comandos do Analytics.
