Comando ASSIGN
Crea una variable y asigna un valor a la variable.
Sintaxis
ASSIGN nombre_variable = valor <IF prueba>
Consejo
Puede omitir la palabra clave ASSIGN, porque Analytics interpreta automáticamente la siguiente sintaxis como una operación de asignación:
nombre_variable = valor
Parámetros
| Nombre | Descripción |
|---|---|
| nombre_variable |
El nombre de la variable a la que se debe asignar el valor. Si la variable no existe, se crea. Si la variable ya existe, se actualiza con el nuevo valor. No utilice caracteres que no pertenezcan al alfabeto inglés, tales como é, en los nombres de las variables. Si utiliza este tipo de caracteres en los nombres de las variables, el script no se podrá ejecutar correctamente. Nota Los nombres de las variables tienen un límite máximo de 31 caracteres alfanuméricos. El nombre puede incluir un guión bajo ( _ ), pero no puede incluir ningún otro carácter especial ni espacios. El nombre no puede comenzar con un número. |
| valor |
El valor que se debe asignar a la variable. Si se crea una nueva variable, el tipo de variable se basa en el tipo de datos en valor. |
| IF prueba Opcional |
Una expresión condicional que debe ser verdadera para crear la variable o asignar el valor a la variable. |
Ejemplos
Asignar un valor a una variable
Usted asigna el valor del campo Cantidad del registro actual a una variable llamada v_cantidad_actual. Dado que v_cantidad_actual es una variable, su valor no cambia a menos que se modifique por medio de otro comando ASSIGN de manera explícita:
ASSIGN v_cantidad_actual= Cantidad
Asignar un valor a una variable de forma condicional
Usted desea actualizar el valor de una variable denominada v_cantidad a 1, pero solo si el valor de otra variable denominada v_recuento es inferior a 10.
Si v_recuento es mayor que o igual a 10, no se realiza ninguna asignación y el valor de v_cantidad se mantiene invariable.
Observe que se omite la palabra clave opcional ASSIGN:
v_cantidad = 1 IF v_recuento < 10
Observaciones
Duración de las variables
Las variables con nombres que no tengan delante un guion bajo se conservan únicamente durante la sesión actual de Analytics.
Si desea que una variable se guarde de manera permanente con un proyecto de Analytics, coloque un guión bajo delante del nombre de la variable:
ASSIGN valor = _nombre_variable
Reasignación de variables utilizadas en un campo calculado o GROUP
Si asigna un valor a una variable existente en las siguientes situaciones, se asigna el nuevo valor pero se mantienen el recuento decimal y la longitud del valor anterior:
- variables que se usan en campos calculados
- variables que se reasignan dentro de un GROUP
La longitud del nuevo valor se completa o se trunca y los decimales se ajustan, si es necesario.
Si reasigna una variable en cualquier otro contexto, se sobrescriben tanto el valor previo como la especificación de decimales y longitud.
Variables creadas por comandos de Analytics
Cuando se ejecutan ciertos comandos, ya sea introduciendo información en los cuadros de diálogo en Analytics o ejecutando scripts, Analytics crea automáticamente variables del sistema. Puede usar estas variables y los valores que contienen, al procesar los comandos de Analytics posteriores.
El valor de una variable del sistema se reemplaza por un valor actualizado si vuelve a ejecutar el mismo comando.
Si desea obtener más información, consulte Variables creadas por comandos de Analytics.
Guía de creación de scripts de ACL 14.1