Comando ASSIGN
Crea una variable y asigna un valor a la variable.
Sintaxis
ASSIGN nombre_variable = valor <IF prueba>
Nota
Es conveniente especificar explícitamente la palabra clave ASSIGN porque hace que los scripts sean más fáciles de leer y de comprender. Sin embargo, puede omitir ASSIGN y simplemente especificar:
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 no ingleses, como é , en los nombres de las variables que se utilizarán en la sustitución de variables. Los nombres de las variables con caracteres no ingleses impiden la correcta sustitución de la variable. 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:
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
Si desea obtener información detallada sobre el uso de las variables, consulte Trabajar con variables en ACLScript.
Duración de las variables
Las variables solo se retienen durante la sesión actual de Analytics. Habitualmente, al cerrar un proyecto de Analytics, todas las variables del proyecto se eliminan automáticamente.
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 _nombre_variable = valor
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 Las variables del sistema creadas por comandos de Analytics.