Comando ASSIGN
Cria uma variável e atribui a ela um valor.
Sintaxe
ASSIGN nome_variável = valor <IF teste>
Dica
Você pode omitir a palavra-chave ASSIGN porque o Analytics interpreta automaticamente a seguinte sintaxe como uma operação de atribuição:
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 utilize caracteres não-ingleses, como "é", no nome das variáveis. Nomes variáveis que contenham caracteres não-ingleses farão com que o script falhe. 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. Como v_valor_atual é uma variável, seu valor não muda a menos que seja explicitamente alterado por outro comando ASSIGN:
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
Duração das variáveis
Variáveis com nomes que não forem precedidos de um sublinhado serão retidas apenas pela duração da presente sessão do Analytics.
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 valor = _nome_variável
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 criadas por comandos do Analytics.
