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.